Connexion d’UVC à UVMS

Cette section détaille la connexion d'Univiewer Console, d'Univiewer Web Console et d'Univiewer Console web start à UVMS, ainsi que la gestion de la télémétrie.

Connexion d'Univiewer Console indépendante

UVC ne peut être lancée que si la variable d'environnement système JAVA_HOME est définie sur le répertoire bin contenant l'exécutable java.

• Sous Windows : appelez l’interface graphique utilisateur à partir du menu Windows : Démarrer > Programmes > AUTOMIC > Univiewer Console > Univiewer console ou exécutez univiewer.exe (à partir du sous-répertoire univiewer).
• Sous Linux : exécutez unistartconsole.ksh (à partir du sous-répertoire univiewer).

Connexion d'Univiewer Web Console

Une fois Univiewer Web Console deployée, pour ouvrir UVC :

1. Ouvrez un navigateur Web
2. Saisissez l’URL d'Univiewer Web Console. Par exemple : http://localhost:8080/univiewer_webconsole_6.<m.bb>
3. L’URL déclenche le téléchargement optionnel de l'applet java d’UVC et démarre la console sur l’ordinateur de l’utilisateur.
4. La boîte de dialogue de connexion s’affiche et permet à l’utilisateur de spécifier l’UVMS à utiliser et le compte utilisateur.

La communication entre l’ordinateur de l’utilisateur et Univiewer Web Console s'effectue en HTTP ou HTTPS. La communication entre Univiewer Web Console et les serveurs (UVMS, UJ, DUAS, Reporter) est propriétaire.

Pour des raisons de performances, assurez-vous que le serveur Web soit installé à proximité des serveurs.

Connexion d'Univiewer Console Web Start

Pour lancer Univiewer Console Web Start à partir d’un navigateur Web distant, saisissez l’URL appropriée dans le navigateur :

Par exemple :

http://monserveur.domaine.com:8080/univiewer_console_webstart_6.<m.bb>

Le nom du serveur et les numéros de ports doivent correspondre à ceux fournis dans le fichier uvc.jnlp situé dans le répertoire racine de l’application.

• Lorsque l’écran d’accueil s’affiche, cliquez Go !
• Dans la fenêtre pop-up « Ouverture d’uvc.jnlp », sélectionnez enregistrer le fichier.
• Par défaut, uvc.jnlp est enregistré sur le bureau de l’utilisateur
• L’icône uvc.jnlp située sur le bureau de l’utilisateur peut à présent être utilisée pour démarrer UVC sans navigateur Web.

Lorsque vous démarrez UVC à partir de Web Start dans Internet Explorer, le dossier du fichier log se trouve dans le dossier personnel de l’utilisateur (C:\Users\%userprofile%\univiewer_console\logs).

Java 11 ne supporte pas la technologie Web Start.

Paramètres de connexion

Lors de la première connexion, la fenêtre de connexion demande les éléments suivants afin d’authentifier l’utilisateur et de déterminer l’UVMS cible :

• Login

  Saisissez le compte utilisateur de connexion à UVMS ("admin" par défaut) :

  • Avec contrôle de casse pour un utilisateur interne (testé en premier).
  • Sans contrôle de casse pour un utilisateur LDAP.

• Password

  Saisissez le mot de passe fourni au cours de l’installation d’UVMS. Le nom d'utilisateur et le mot de passe doivent être composés des caractères suivants uniquement : ABCDEFGHIJKLMNOPQRSTUVWXYZabcdefghijklmnopqrstuvwxyz0123456789!#&'()+,-.:;>=<?@[]_{|}~
  

• Management Server

  Identifie l’UVMS cible : <nom de nœud> [<nom d'hôte>:<numéro de port>]
  Cet historique liste l’ensemble des connexions réussies à UVMS. Il peut être effacé en cliquant Advanced > Clear history.
  

• Advanced

  Permet la modification de l’UVMS cible.
  

• SSL

  Cochez cette case pour obtenir une communication cryptée SSL entre UVC et UVMS. Ceci n'est possible que si UVMS a été configuré pour fonctionner en mode SSL.

• Hostname

  Nom d’hôte UVMS. La connexion échoue si UVMS n’est pas démarré.

• Port

  Saisissez le numéro de port validé au cours de l’installation d'UVMS. Par défaut :

  • 4184 pour une communication en clair
  • 4443 pour une communication SSL

• Centralized User Preferences

  Cochez cette case pour centraliser dans la base de données UVMS (en plus de l'enregistrement local sur ce poste de travail) vos préférences utilisateurs du menu d'UVC : Administration > Paramètres utilisateur, vos marque-pages et vos filtres des listes. De cette façon, si vous utilisez un autre poste de travail, vous pouvez récupérer vos préférences utilisateur en cochant cette case lors de votre prochaine connexion. Plusieurs cas de figures se présentent :

  • Si vous cochez cette case et que vos préférences utilisateur n'existent pas dans UVMS, vos préférences utilisateurs locales seront centralisées dans la base UVMS. Un message sera affiché pour le confirmer.
  • Si vous cochez cette case et que vos préférences utilisateurs existent déjà dans UVMS, vous les retrouverez dans UVC. Vos préférences utilisateurs centralisées dans l'UVMS seront rapatriées en local et écraseront vos préférences utilisateurs locales.
  • Si vous avez déjà coché cette case pour la précédente connexion de cet utilisateur sur cet UVMS sur ce poste de travail, elle apparaîtra cochée.
  • Si vous ne souhaitez pas utiliser vos préférences utilisateur centralisées sur ce poste de travail, décochez la case.

  Les préférences utilisateurs sont stockées localement dans deux fichiers:

  • localsettings.xml contient les préférences utilisateurs du mode administration et les filtres des listes
  • bookmarks.xml contient les marques pages.

Cliquez sur Connect pour établir la connexion ou sur Exit pour fermer la fenêtre sans tentative de connexion.

Si la connexion ne peut pas être établie avec l'UVMS ciblé, un message est affiché pour informer l'utilisateur. Si plusieurs UVMS sont déclarés dans UVC, ce message contient la liste des hôtes ciblés; l'utilisateur peut alors quitter la tentative de connexion. S'il conserve le message, la connexion sera établie automatiquement dès que possible. La durée d'une tentative de connexion avec un hôte est modifiable dans le paramètre nœud UVMS_UVC_RECONNECTION_TIMER.

Si le message suivant est affiché : "The telemetry settings are not configured. Please contact your administrator to proceed. (Les paramètres de la télémétrie ne sont pas configurés. Veuillez contacter votre administrateur pour poursuivre.)", reportez-vous à la section Télémétrie.

Historique des connexions

Par défaut, les données spécifiées lors de la première connexion sont enregistrées dans un historique des connexions (local au poste de travail de l'utilisateur) dans le répertoire suivant :

• Sous Windows : C:\Utilisateurs\<windows user>\univiewer_console\...
• Sous Linux : /<login>/.univiewer_console/...

Répertoire des paramètres de connexion

UVC utilise par défaut la variable java user.home pour déterminer le répertoire de stockage des préférences utilisateurs d'Univiewer Console.

Pour modifier ce répertoire par défaut, la variable uphd doit être valorisée avec le nom du répertoire dans lequel UVC crée un sous-répertoire univiewer_console contenant les préférences utilisateurs.

Ce répertoire peut contenir des variables système encadrées de caractères $.

Sous Windows, un caractère \ doit être doublé : \\.

Exemples :

uphd=$HOMEPATH$

uphd=Z:\\users\\$USERNAME$

<property name="uphd" value="Z:\\users\\$USERNAME$"/>

Reportez-vous à l'un des paragraphes ci-dessous (selon le mode d'installation d'UVC) pour déterminer la méthode de définition de cette variable.

• UVC standalone : l'administrateur peut créer un fichier nommé uphd.properties dans le sous-répertoire data d'Univiewer Console. Ce fichier doit respecter la syntaxe suivante :

uphd=<répertoire>

Le fichier uphd.properties est conservé par une mise à niveau d'UVC. Si ce fichier est introuvable ou contient une syntaxe incorrecte, le répertoire par défaut est utilisé.

• UVC Web Console : le fichier WEB-INF\conf\UVC_config.properties doit être modifié en ajoutant la ligne suivante :

uphd=<répertoire>

• UVC Web Start : le fichier .jnlp doit être modifié en ajoutant la ligne suivante :

<property name="uphd" value="répertoire"/>

Préférences utilisateurs

Les préférences utilisateurs regroupent :

• Les préférences utilisateurs du menu d'UVC : Administration > Paramètres utilisateur
• Les marque-pages
• Les filtres des listes

Les préférences utilisateurs sont stockées localement à UVC (dans le répertoire décrit ci-dessus) dans deux fichiers :

• localsettings.xml contient les préférences utilisateurs du mode administration et les filtres des listes
• bookmarks.xml contient les marques pages.

Les préférences utilisateurs peuvent être centralisées dans UVMS à la demande de l'utilisateur lors de sa connexion à UVC, selon les règles décrites au paragraphe Paramètres de connexion ci-dessus.

Si les préférences utilisateurs sont centralisées, elles sont enregistrées localement et dans UVMS dès que la modification est enregistrée. Si la connexion à UVMS est temporairement impossible, lors du rétablissement de la connexion l'utilisateur devra manuellement enregistrer n'importe quelle préférence utilisateur (préférence, marque page ou filtre) pour que les préférences en attente soient enregistrées.

Des commandes UVMS permettent d'agir sur les préférences utilisateurs centralisées dans UVMS :supprimer, importer et exporter. Reportez-vous à la section Préférences utilisateur.

Connexion d'UVC à une bascule UVMS

Par défaut, Univiewer Console se connecte au nœud UVMS demandé.

Dans une bascule UVMS, si le nœud demandé n'est pas accessible, UVC pourra se connecter automatiquement au nœud UVMS disponible.

Pour cela, la configuration suivante doit être réalisée (une seule fois). Dans la fenêtre de connexion d'UVC :

• Management server: sélectionnez Clear History pour effacer les connexions précédentes.
• Hostname: saisissez le nom d'un nœud UVMS actif
• Saisissez le nom de l'administrateur et son mot de passe
• Cliquez Connect
• Déconnectez-vous par le bouton Logout.

En réalisant cette configuration, Univiewer Console connaît désormais tous les nœuds de la bascule.